home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 22 / Cream of the Crop 22.iso / os2 / ext2_200.zip / 32DRV130.ZIP / READ.ME < prev   
INI File  |  1996-09-18  |  5KB  |  117 lines
  1. [$Header: D:/32bits/ext2-os2/doc/mwdd32/RCS/READ.ME,v 1.1 1996/09/17 22:01:49 Willm Exp Willm $]
  2. ╔═══════════════════════════════════════════════════════════════════════╗
  3. ║ 32 bits OS/2 device driver and IFS support driver. Provides 32 bits   ║
  4. ║ kernel services (DevHelp) and utility functions to 32 bits OS/2 ring  ║
  5. ║ 0 code (device drivers and installable file system drivers).          ║
  6. ║ Copyright (C) 1995, 1996 Matthieu WILLM                               ║
  7. ║                                                                       ║
  8. ║  This program is free software; you can redistribute it and/or modify ║
  9. ║  it under the terms of the GNU General Public License as published by ║
  10. ║  the Free Software Foundation; either version 2 of the License, or    ║
  11. ║  (at your option) any later version.                                  ║
  12. ║                                                                       ║
  13. ║  This program is distributed in the hope that it will be useful,      ║
  14. ║  but WITHOUT ANY WARRANTY; without even the implied warranty of       ║
  15. ║  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the        ║
  16. ║  GNU General Public License for more details.                         ║
  17. ║                                                                       ║
  18. ║  You should have received a copy of the GNU General Public License    ║
  19. ║  along with this program; if not, write to the Free Software          ║
  20. ║  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.            ║
  21. ╚═══════════════════════════════════════════════════════════════════════╝
  22.  
  23.                    MWDD32 VERSION 1.30 BETA
  24.  
  25.  
  26. WHAT IS MWDD32  ?
  27. -----------------
  28.  
  29.     mwdd32 is a package that allows the implementation of 32 bits OS/2 device drivers
  30. (BASEDEV and DEVICE) as well as 32 bits Installable File Systems (IFS). It is composed
  31. of several parts :
  32.     - a base device driver (mwdd32.sys) that provides kernel services (DevHelp)
  33.       and utility functions callable from 32 bits ring 0 code.
  34.     - a static library (fsh32.lib) that provides thunks from 16 bits IFS entry points
  35.       to 32 bits, and 32 bits interfaces to FSHelper functions. 
  36.     - a sample 32 bits BASEDEV base device driver skeleton, with sources.
  37.     - a sample 32 bits DEVICE device driver skeleton, with sources.
  38.     - a sample 32 bits IFS (Installable File System) driver skeleton, with sources.
  39.     - a sample 32 bits OS/2 SES (Security Enabling Services) base device driver skeleton, 
  40.       with sources.
  41.  
  42.     I created mwdd32 because I started to port my Linux ext2fs IFS to 32 bits
  43. some times ago, and to do this I had to write 32 bits devhelp interfaces (thunks) and other 
  44. routines. I thought it would be useful to make other clients than my IFS profit from
  45. this work. That's why I isolated them in a separate driver and created MWDD32.SYS.
  46.  
  47.     mwdd32 is still work in progress : not all DevHelp are implemented, but only those
  48. I needed to port ext2-os2 to 32 bits. Suggestions and contributions are welcome
  49. to help me enhance mwdd32. For the moment the programming documentation is still 
  50. incomplete, but will be better in the next release !
  51.  
  52. COPYRIGHT NOTICE :
  53. ------------------
  54.  
  55. This package is licensed under terms of the the GNU General Public License. 
  56. See the file COPYING for details.
  57.  
  58. If you want to use my own parts (parts that do not contain code from others)
  59. but not under the GNU General Public License you must contact me and sign an
  60. agreement with me.
  61.  
  62. WARNING :
  63. ---------
  64.  
  65. - MWDD32 IS BETA SOFTWARE. I release it mainly to allow people profit from it 
  66.   before the 32 bits version of ext2-os2 is ready, and to get feedback on it 
  67.   (and contributions ...). 
  68. - MWDD32 IS ONLY USEFUL TO DEVICE DRIVER WRITERS. IT IS *TOTALLY USELESS* FOR 
  69.   NORMAL USERS. DON'T INSTALL IT IF YOU DON'T PLAN TO WRITE DEVICE DRIVERS !!!
  70. - FOR THE MOMENT MWDD32 IS EXPERIMENTAL WORK, STILL IN PROGRESS. PROGRAMMING 
  71.   INTERFACES ARE SUBJECT TO CHANGE. MWDD32.SYS IS PROBABLY STILL UNSTABLE.
  72.  
  73. REQUIREMENTS :
  74. --------------
  75.  
  76. - OS/2 WARP with fixpack 17 is required. Bare OS/2 WARP should also work, but
  77.   I didn't test it yet. 
  78. - OS/2 WARP with fixpack 17 is required for the sample SES driver. (it will not
  79.   work with bare OS/2 WARP)
  80. - IBM VisualAge C++ 3.0 with latest CSD, the IBM Devcon DDK V2, as well
  81.   as IBM ALP 4.0 are needed to write 32 bits drivers using this package.
  82. - A file system supporting long file names (eg HPFS for instance) is required.
  83.  
  84.  
  85. INSTALLATION AND USAGE INSTRUCTIONS :
  86. ------------------------------------
  87.  
  88.   Installing mwdd32.sys :
  89.      Simply copy it into \os2\boot on your boot drive, and add the following line in
  90.      your CONFIG.SYS :
  91.     BASEDEV=MWDD32.SYS
  92.  
  93.      NOTE : mwdd32.sys is REQUIRED to make all sample drivers work. It must be loaded 
  94.             before any drivers that use it.
  95.  
  96.   Sample drivers sources and binaries are located in the file mwdd_src.zip.
  97.  
  98. WHERE TO FIND MWDD32 :
  99. ----------------------
  100.  
  101. ftp://ftp-os2.nmsu.edu/os2/dev32/32drv130.zip
  102. ftp://ftp.leo.org/os2/drivers/source/32drv130.zip
  103. ftp://ftp-os2.cdrom.com/pub/os2/dev32/32drv130.zip
  104.  
  105. DISCLAIMER :
  106. ------------
  107.  
  108. The fact that I work for IBM has nothing to do with this package : this is
  109. spare time work. It is ***NOT*** official IBM support for 32 bits OS/2 
  110. physical device drivers or IFS.
  111.  
  112.  
  113. Matthieu WILLM
  114. willm@ibm.net          (home)
  115.  
  116.  
  117.